home *** CD-ROM | disk | FTP | other *** search
/ PC Shareware 1997 February / PC Shareware 1997-02.iso / programy / e! / api / killdll.do_ / killdll.DOC
Encoding:
Text File  |  1995-03-05  |  3.4 KB  |  102 lines
  1.  
  2.  
  3.  
  4.                 The DLL Killer
  5.  
  6.                  version 1.1
  7.  
  8.  
  9.             A utility for Windows programmers
  10.  
  11.                  by
  12.  
  13.               Patrick Philippot
  14.               MainSoft, France
  15.  
  16.               CIS : 72561,3532
  17.  
  18.  
  19.              Public Domain Software
  20.  
  21.  
  22.  
  23.      WARNING!! WARNING!! WARNING!! WARNING!! WARNING!! WARNING!!
  24.  
  25.      This program is definitely not intended for end-users. It's a
  26.     debugging aid that should be used only by programmers and technical
  27.     support people.
  28.  
  29.  
  30.      KillDLL is a small utility that I have written for my own needs
  31.     and that may be useful to you. Here it is, free of charge and for use
  32.     at your own risk.
  33.  
  34.  
  35.      Why a DLL killer?
  36.  
  37.      While writing the E! for Windows API (E! for Windows is a text
  38.     editor that we recently released as a shareware), I frequently found
  39.     myself with a main program (E!) that had hung because of a bug in the
  40.     extension DLL I was currently debugging.
  41.  
  42.      So, the program terminated abnormally and could not unload all
  43.     the other extension DLLs it had loaded. The next time I wanted to run
  44.     E!, all these DLLs were still there and their initialization code was
  45.     not executed (it is executed only once when the DLL are first
  46.     loaded). This is of course a rather unsafe situation because E!
  47.     extension DLLs very often need to communicate with the running copy
  48.     of E! when they are installed. The only way to return to a safe
  49.     situation was to exit Windows and to launch it again.
  50.  
  51.      I think this or similar situations can happen to you. That's why
  52.     I decided to make this small program available.
  53.  
  54.      KillDLL allows you to unload an orphaned DLL without having to
  55.     exit Windows. An orphaned DLL is a DLL that has a non-zero usage count
  56.     but that is not likely to be unloaded by a call to FreeLibrary because
  57.     no further application is aware of it.
  58.  
  59.      Run KillDLL. It will show you a small dialog box where all the
  60.     currently loaded DLLs are listed. Unlike other similar programs,
  61.     KillDLL shows you only the DLLs, not the other code modules. Select
  62.     the DLL you want to unload (you may select multiple DLLs) and click
  63.     on the "Kill" button. A warning message will be issued for each
  64.     unloaded DLL if "Confirm On Delete" is checked. Click OK if you
  65.     maintain your decision. The DLL list will be automatically refreshed.
  66.  
  67.      You can unload ANY DLL in the system. So, be sure of what you're
  68.     doing. You can even unload KERNEL! The result will be an immediate
  69.     exit from Windows.
  70.  
  71.      KillDLL uses the FreeLibrary API to unload the DLL. So, the DLL
  72.     exit procedure will always be executed.
  73.  
  74.      KillDLL uses undocumented information to be able to separate
  75.     DLLs from other modules. Thanks to "Undocumented Windows", the famous
  76.     book written by Schulman, Maxey and Pietrek. Be aware that this
  77.     program may not work with future versions of Windows.
  78.  
  79.      KillDLL is a Public Domain software and nobody is allowed to
  80.     charge any amount of money for distributing this program.
  81.  
  82.      If you want any information about our E! editor for Windows
  83.     please contact me on Compuserve [72561,3532] or fax your request to:
  84.  
  85.      Juergen Egeling Computer
  86.      Werderstr. 41, 76137 Karlsruhe, Germany.
  87.      Tel: +49 721 373832
  88.      Fax: +49 721 373842
  89.  
  90.      or
  91.  
  92.      MainSoft SARL
  93.      15, avenue des Pres Pierre
  94.      91210 Draveil, France
  95.      Tel/Fax: +33 1 69 40 94 85
  96.  
  97.  
  98.     Have fun!
  99.  
  100.     Patrick Philippot
  101.     08/13/93
  102.